home *** CD-ROM | disk | FTP | other *** search
/ The Whacked Mac Archives / The Whacked Mac Archives Version 1.0 (L0pht Heavy Industries, Inc.)(1996).iso / Pub (Expanded) / Emulators / C64 / 0.4 - README next >
Text File  |  1994-05-10  |  13KB  |  325 lines
  1. Commodore 64 Emulator Version 0.4 Documentation
  2. (C) 1993-4 Earle F. Philhower III (st916w9r@dunx1.ocs.drexel.edu)
  3.  
  4. (Also glance over the version 0.3, 0.2, 0.1 readmes for more information)
  5. -------------------------------------------------------------------------------
  6. -------------------------------------------------------------------------------
  7. Table Of Contents
  8.  
  9.  
  10.     1)    What's New In This Release?
  11.     
  12.     2)  Quick-Start Guide
  13.         a)  Keyboard
  14.         b)  Disk Images
  15.         c)  Tape Images
  16.         d)  RAM Images
  17.         e)  Preferences
  18.     
  19.     3)  Frequently Asked Questions
  20.     
  21.     4)  How Can I Help?
  22.  
  23.     5)  Credits and Eulogy :<
  24.  
  25. -------------------------------------------------------------------------------
  26. -------------------------------------------------------------------------------
  27. 1)  WHAT'S NEW IN THIS RELEASE?
  28.  
  29. General:
  30.     Faster Integrated C 6510 processor
  31.         (about 5% faster than 68k coded)
  32.     Power PC native version (same source as 68k)
  33.     Included undocumented opcodes
  34.     Cleaner source code in some files
  35.     There's some kind of documentation!
  36.  
  37. Video:
  38.     Multicolor Mode support
  39.     B/W sprite handling has been fixed
  40.     Double sized display
  41.  
  42. Interface:
  43.     Dragging one VIC window drags both
  44.     About box centered
  45.     Should switch cursor better
  46.     Loading a RAM image updates display
  47.  
  48. Bugs:
  49.     The color VIC window sometimes goes off into the upper-left hand corner
  50.     of the screen and crashed the C64.  I haven't a clue as to why, as the BW
  51.     version doesn't exhibit this behavior.
  52.  
  53.     There have been some problems with some international setups and EC040 Macs
  54.     (the drain bramaged variety Apple sells in the Performa line)  I don't have
  55.     any way of testing where the program is dying, since Drexel doesn't have
  56.     those.
  57.  
  58.  
  59. -------------------------------------------------------------------------------
  60. -------------------------------------------------------------------------------
  61. 2)  QUICK START GUIDE
  62.  
  63. 1.  First figure out which executable you need to run:  If you have a PPC Mac
  64.     use "Commodore 64 PPC", otherwise use "Commodore 64"
  65.     [PPC owners can also use the "Commodore 64" execuatble, only it will run
  66.      much, much, much, slower]
  67.      
  68. 2.  Once you've got it running you're sitting at a virtual C=64!  That simple!
  69.     Device #8 is the virtual 1541 drive.  Device #9 is an interface into the Mac
  70.     filesystem (not fully complete, but you can load and save files to the
  71.     directory where Mac64 executable resides).  Device #4 is a printer whose output
  72.     goes into a file called "PRINTER" in the startup directory  (Not fully done
  73.     either).
  74.     
  75. 3.  To toggle between "Running" and "Suspended" modes on the C64 window, just
  76.     click in the window.  When you're running the cursor is normally a C=, and
  77.     when you're suspended it is normally a standard arrow.
  78.  
  79. --
  80. Keyboard
  81.  
  82.     They keyboard mappings are very simple.  All letters and numbers are done
  83.     as you would expect.  However the FUNCTION keys are accessed via an
  84.     Option-# press.  (I.e. F-7 = Option-7)
  85.     
  86.     Cursor keys work (you DON'T need to SHIFT-UP to go down...)
  87.  
  88.     Some of the Control keys are implemented via CTRL-x.  If it doesn't work
  89.     for you then I've not added that key!
  90.  
  91.                         DELETE    =    C64 delete
  92.                         ESC    =    RUN/STOP
  93.                         `    =    RUN/STOP-RESTORE
  94.                 
  95.     When in emulation mode, COMMAND-<key> is in effect, and you can bring up
  96.     menus w/o stopping the emulation.
  97. --
  98. Disk Images
  99.  
  100.     In order to access a D64 disk image (which is nothing more than a raw sector
  101.     dump of a Commodore 1541 format floppy disk) you can either:
  102.     
  103.         a.  Select "Attach Floppy Image..." from the "Devices" menu to "insert"
  104.             a pre-made diskette into the virtual 1541 (device #8)
  105.             
  106.         b.  Double-Click on a D64 image (if it has the proper icon (5.25" disk))
  107.             to insert it...
  108.             
  109.         c.  Select "Create Floppy Image..." from the "Devices" menu to "format"
  110.             a new diskette.  You'll have to select a *Macintosh* file name to
  111.             create.  It'll automatically "insert" the disk for you.
  112. --
  113. Tape Images
  114.  
  115.     A lot of single file games are being distributed in T64 format.  To load
  116.     a T64(tape image) file into the emulator, you can either:
  117.     
  118.         a.  Select "Load Tape File..." from the "Devices" menu.  Select the
  119.             tape and it will be loaded into C= memory.  You *MUST* type "RUN"
  120.             in the C64 window to start the program, once it's loaded.
  121.         
  122.         b.  Double click on the icon of a T64 image (It should look just like
  123.             an audio cassette) to load it.  Again, you must "RUN" it to make
  124.             it go.
  125.     
  126.     There is no way currently to make T64 images from the emulator.
  127. --
  128. RAM Images
  129.  
  130.     A RAM image is a complete saved state of the Commodore 64 window.  If you
  131.     know what a "freeze" cartridge is, you get the idea.  Basically the entire
  132.     machine (RAM, processor) are stored in a file which can be later accessed.
  133.     So you can load up Zork (assuming it works...:[) go on for an hour, save
  134.     a RAM image.  Later you can resume the game by loading the RAM image.
  135.     
  136.     To save a RAM image:
  137.         Select "Save RAM Image..." from the "File" menu.  Enter a name and
  138.         viola!  RAM image is saved.
  139.     
  140.     To load a RAM image you can either:
  141.         
  142.         a.  Select "Load RAM Image..." from the "File" menu.  Select the file
  143.             and the processor will be restored to the saved state.
  144.         
  145.         b.  Double-click on a RAM image icon (It looks like an IC)
  146.         
  147.     Note that the processor must be running in order to make the program go
  148.     after loading it.
  149. --
  150. Preferences
  151.  
  152.     The preferences dialog, accessible from the "File" menu allows you to
  153.     change the way the Commodore 64 is emulated.  You can switch between a
  154.     color(slow) and b/w(fast) version of the VIC, choose between three
  155.     different processor emulations, and other neato stuff.
  156.  
  157. Video:
  158.     Byte Align Window:
  159.         This toggles between making the window appear on an 8-bit boundary.
  160.         On machines set up to run with a monitor depth of 1 pixel (b/w) you
  161.         can get a significant speed increase by doing this.  When you have
  162.         the monitor set up to display in color, this option will NOT speed
  163.         up the display.  Useful on "aquarium" Macs.
  164.     
  165.     B/W or Color:
  166.         Chooses the type of video output from the Commodore you want.  The
  167.         color version only runs on machines with color Quickdraw (but will NOT
  168.         crash your machine if you don't).  B/W is relatively fast and more
  169.         debugged than the color version.  The color version is exceedingly slow
  170.         on almost any machine, but supports hi-res, color, sprites, etc.
  171.     
  172.     Double Size:
  173.         Doubles the size of the video display.  If you have a 640x480 monitor
  174.         you can display the double-sized color or BW window so you don't get
  175.         eyestrain.  Note that this is MUCH slower than non-double size.
  176.     
  177. Processor:
  178.     Skip RAM Test:
  179.         Patches the KERNEL ROMs in memory to make the Commodore 64 skip the
  180.         memory test.  It's 100% compatible with any piece of software that will
  181.         run on the emulator.  Also makes the reset MUCH faster.
  182.     
  183.     68k or C or Integrated C:
  184.         Allows you to choose between different emulations for the 6510, the
  185.         microprocessor at the heart of the Commodore 64.  I recommend using
  186.         the "Integrated C" on *ALL* platforms, since it is much faster and
  187.         includes undocumented opcodes.  The 68k is just slightly slower than
  188.         the Integrated C, and the plain old C is about 25% slower.
  189.         Note that on the PPC version 68k=Integrated C.
  190.  
  191.  
  192. -------------------------------------------------------------------------------
  193. -------------------------------------------------------------------------------
  194. 3)  FREQUENTLY ASKED QUESTIONS
  195.  
  196. *****
  197. Getting in touch with me about this emulator:
  198.  
  199.     Send all email questions, comments, suggestions to:
  200.                     st916w9r@dunx1.ocs.drexel.edu
  201.     PLEASE INCLUDE THE VERSION OF THE EMULATOR THAT YOU ARE USING IN YOUR
  202.     FIRST MESSAGE.  I'd also like to hear where you got the emulator from
  203.     (AOL, internet, BBS, etc.)
  204. *****
  205. Getting the latest version:
  206.     I will be storing the latset revisions on _the premier_ Commodore archive:
  207.                                 watson.mbb.sfu.ca
  208.     Access it via anonymous FTP, go to the "emulator" directory.  The latest
  209.     version will always be called:
  210.                                 MAC64-xx.HQX
  211. *****
  212. XXXXXX won't run:
  213.     Yup.  You're probably right.  The emulator right now is built for speed and
  214.     ease-of-comprehension.  Either wait for a later version, or reprogram what you
  215.     have...
  216. *****
  217. Are there any other Commodore emulators:
  218.     By far the best Commodore 64 emulator available for the IBM PC is:
  219.                                 C64S09x.ZIP
  220.     You can get it off of the "watson..." site mentioned above.  Also get
  221.     the following file:            ROMCODE.C64
  222.     
  223.     For the Macintosh, you're running the only emulator available, so it's the
  224.     best!!!
  225.     
  226.     If you've got X11 and some time on your hands you can get X64, a really
  227.     good emulator under UNIX & X11:
  228.                                 x64-0.2.x.tar.gz
  229.     In fact, I'm using some code from X64 in my current emulator!
  230. *****
  231. Q.  What's a "xxx.D64" or "xxx.T64" file?
  232.  
  233. A.  A *.D64 file is a binary image of a 1541 floppy disk.  To use it with the
  234.     emulator, use "Attach Floppy Image" from the Devices menu.  Just use the
  235.     regular "LOAD "xxxxx",8" commands in C64 BASIC to load any of the programs
  236.     on the disk.  Enter "RUN <enter>" to make the program RUN after LOADing it.
  237.     
  238.     A *.T64 file is just a hacked copy of a C64 file.  In theory it supports
  239.     storing multiple programs per image, but as of now 99.9% of the images are
  240.     only holding one file.  To load a T64 file, select "Load Tape Image" from
  241.     the Devices menu.  Then type "RUN" to make the program go.
  242. *****
  243. Q.  How can I get 1541 disks from my Commodore to my Mac?
  244.  
  245. A1. You can't.  Use a PC with "disk64e" or "x1541" to transfer the files to a
  246.     IBM format floppy, the use PC Exchange to copy the files from the IBM
  247.     disk to your Mac.
  248. A2. Use a RS232 converter from your C64's user port and a Null-Modem cable
  249.     between the converter and the Mac.  *DO NOT CONNECT YOUR C64 TO YOUR MAC/PC
  250.     WITHOUT AN RS232 CONVERTER.  YOU WILL DAMAGE YOUR C64 BY DOING SO!*
  251. *****
  252. Q.  I want to do some work with your code.  What should I do if I want my
  253.     changes to be inclued in one of your later C64 releases?
  254.     
  255. A.  I'm very open to changes/additions to my program.  In fact, almost 30% of
  256.     the code is now from others.  If you've done some work send me some mail
  257.     at Drexel, and *comment* any changes you make.  It'll make my work much
  258.     easier!  And, of course, you've got to allow distribution of your changes
  259.     unde the GNU GPL.
  260. *****
  261. Q.  Is there a joystick?
  262.  
  263. A.  No.  Not yet.  Right now I've got to get the games to work...
  264.  
  265.  
  266. -------------------------------------------------------------------------------
  267. -------------------------------------------------------------------------------
  268. 4)  HOW CAN YOU HELP?
  269.  
  270.     If you've got the talent and the time, go through the source code.  Find
  271.     and eradicate any bugs you find.  Add any features you think should be
  272.     added.  And send all of your changes to me at my email address.
  273.     
  274.     I'm more than happy to assist in any work you're doing on the emulator,
  275.     just don't start asking me to do your CompSci homework!
  276.     
  277.     UPLOAD THIS TO AOL SO THAT I DON'T KEEP GETTING 10 MESSAGES A DAY FROM
  278.     PEOPLE WHO DON'T HAVE INTERNET ACCESS ASKING ME TO MAIL THEM MY PROGRAM!
  279.  
  280.  
  281. -------------------------------------------------------------------------------
  282. -------------------------------------------------------------------------------
  283. 5)  CREDITS AND EULOGY   :[
  284.  
  285.     Well, Commodore International is dead.  A moment of silence while the
  286.     credits roll, please:
  287.     
  288.     68000 6510 Simulator:  George T. Talbot        <ugtalbot@mcs.drexel.edu>
  289.     Color VIC Display:     Eric M. Stadtherr          <emstadth@iastate.edu>
  290.     MetroWerks, PPC:       Johnathon L. Suker             <jlsuker@ucis.edu>
  291.     Major Testing:         Georg Schwarz   <georg@marie.physik.tu-berlin.de>
  292.     Optimization, PPC:     Peter Creath              <peterc@gnu.ai.mit.edu>
  293.     Tape Image Format:     Werner Zsolt               <mttto22@ursus.bke.hu>
  294.  
  295.      (If I've forgotten you, drop me a line and I'll correct my oversight)
  296.  
  297.  
  298. -------------------------------------------------------------------------------
  299. -------------------------------------------------------------------------------
  300. "Commodore 64 Emulator...
  301. It's not much, but it's the *only* Commodore 64 you can run on your Mac!"
  302.  
  303. Any user suggestions, bug-fixes, updates please email me at Drexel Univ.
  304. (st916w9r@dunx1.ocs.drexel.edu).  A 1.0 release doesn't seem to be too far
  305. away, as most things are already implemented!  [Yeah, right...hahahaha]
  306.  
  307. You can also get in contact with me on ISCA BBS [telnet whip.isca.uiowa.edu]
  308. under the handle (suprise) "Earle."  I frequent the "Antique Computers" forum.
  309.  
  310.     This program is free software; you can redistribute it and/or modify
  311.     it under the terms of the GNU General Public License as published by
  312.     the Free Software Foundation; either version 2 of the License, or
  313.     (at your option) any later version.
  314.  
  315.     This program is distributed in the hope that it will be useful,
  316.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  317.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  318.     GNU General Public License for more details.
  319.  
  320.     You should have received a copy of the GNU General Public License
  321.     along with this program; if not, write to the Free Software
  322.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  323.  
  324. (C) 1993-4 Earle F. Philhower III (st916w9r@dunx1.ocs.drexel.edu)
  325.